Skip to main content

Market Data

Powered by the xt-market skill. No API Key is required for any of it — it works right after installation.

Symbol format: lowercase with an underscore, btc_usdt. Say "BTC", "BTC/USDT", or "BTCUSDT" and it is converted automatically.


Spot Market Data

ToolPurposeKey parameters
xt_spot_ticker24h data: last price, OHLC, change, volume and turnoversymbol
xt_spot_top_moversUSDT pair rankingsdirection: gainers / losers / volume, limit
xt_spot_depthOrder book levelssymbol, limit
xt_spot_klinesKlinesinterval: 1m/5m/15m/30m/1h/4h/1d/1w, limit
xt_spot_symbol_infoSymbol rules: price/quantity precision, minimum notionalsymbol

Futures Market Data

ToolPurposeKey parameters
xt_futures_tickerLast price, mark price, index price, best bid/ask, change, volume and turnoversymbol
xt_futures_depthOrder booksymbol, level
xt_futures_klinesKlinesSame as spot
xt_futures_funding_rateCurrent funding rate + next settlement timesymbol
xt_futures_funding_rate_historyHistorical funding rate seriessymbol, limit
xt_futures_contract_infoContract specs: face value per contract, precision, max leveragesymbol

Usage Examples

"What's the BTC price right now"
"Top ten gainers today"
"Which coins have the highest turnover"
"How's the order book depth for ETH"
"Give me the last 24 hourly candles for SOL"
"What's the spread between BTC perp mark price and index price"
"What's the funding cost of going long BTC right now"

Spot Price vs Futures Price

For the same coin, spot and perpetual prices usually differ slightly:

  • Last price: the actual traded price
  • Mark price: used to compute unrealized PnL and liquidation, derived as a weighted value from the index price, resistant to manipulation
  • Index price: a weighted average of spot prices across multiple exchanges

Use mark price to judge position risk, and last price to judge execution.


Next Steps